PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUFONDtoFontID

Finds the ATSUI font ID corresponding to a font family number.

OSStatus ATSUFONDtoFontID (
                     short iFONDNumber,
                     Style iFONDStyle,
                     ATSUFontID *oFontID);
iFONDNumber
The font family number of the font whose ID you want to obtain.

iFONDStyle
A value of type Style. Pass the font family style, if it exists, of the font whose ID you want to obtain. Font family styles exist in fonts that split a font family into several font family numbers.

oFontID
A pointer to a value of type ATSUFontID. On return, the ID corresponding to the specified font family number. If there are no installed fonts with the matching the specified font family number, ATSUFONDtoFontID passes back the constant kATSUInvalidFontID and returns the result code kATSUInvalidFontErr. If a font exists with the specified font family number and style, but it is incompatible with ATSUI, ATSUFONDtoFontID passes back the constant kATSUInvalidFontID and returns the result code kATSUNoCorrespondingFontErr. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
Font family numbers were used by QuickDraw to represent fonts to the Font Manager. Some of these fonts do not have font IDs (even if they are compatible with ATSUI). For a list of fonts that are not compatible with ATSUI, see the discussion for ATSUFontCount.

ATSUI assigns font IDs at run-time. As a result, font IDs can change across installs.

VERSION NOTES
Available beginning with ATSUI 1.0.

© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)